Home > Overview best-sellers card (top products ranked by revenue MTD)
Returns up to ten best-selling products for the current calendar month ranked by revenue in the company’s base currency, with total units and average price alongside the product image.
Authorizations
Bearer token authentication. Requires a company-admin token
whose role holds reports.view. Additionally, the caller's
company must have ANALYTICS_DASHBOARD enabled — otherwise
every endpoint returns 404.
Query Parameters
ISO alpha-2 code of one of the requesting company's configured
countries (see GET /countries). When present, every service
on this endpoint filters its data to that country and reports
money in the country's own currency. Omit (or send "all")
for the aggregate-across-countries view, which is the default
and matches pre-Phase-004 behavior. Unknown ISO codes or ones
the company is not configured for return 400.
"US"
Response
Best-sellers card payload
Top-selling products for the current calendar month, ranked by revenue descending. Empty array when the company has no revenue-recognized orders in the window.